home *** CD-ROM | disk | FTP | other *** search
/ United Public Domain Gold 2 / United Public Domain Gold 2.iso / utilities / pu429.dms / pu429.adf / MAGNUM.docs < prev    next >
Text File  |  1993-09-29  |  9KB  |  256 lines
  1. -------------------------------------------------------------------------------
  2.  
  3.  
  4. @2                  ####   ####  #### ####   ####
  5.                   ####  ####   #### ####   ####
  6.                   #### ####    #### ####   ####
  7.                   ################# ####   ####
  8.                   ################# ####   ####
  9.                   #### ####    #### ####   ####
  10.                   ####  ####   #### ####  ####  ##########
  11.                   ####   ####  #### #########  ###########
  12.  
  13.  
  14.                                   @1PRESENTS
  15.  
  16.                                  @3MAGNUM V1.9@1
  17.  
  18.  
  19. -------------------------------------------------------------------------------
  20.  
  21.  
  22.  
  23.  
  24.  
  25. @2INTRODUCTION@1
  26. -------------------------------------------------------------------------------
  27. Magnum is a utility that allows you to make disk magazines with ease.
  28. It uses a system that has been tried, tested, and is now used with the
  29. majority of disk magazines.  It follows the style of Raw, Grapevine,
  30. Deadlock, Hexagone, Big Business, etc.
  31. Of course, using this program doesn`t replace your own coded versions, but if
  32. you don`t know how to code, or haven`t got the time and want to produce a disk
  33. magazine, then Magnum is all you`ll probably need.
  34.  
  35.  
  36.  
  37.  
  38. @2HOW DOES MAGNUM WORK ?@1
  39. -------------------------------------------------------------------------------
  40. Magnum works by reading a text file called Magnum.index from disk. This
  41. file is configured to your needs. It details the title of your article and
  42. the path from which it is to be loaded, and also the colours you want.
  43. Magnum.panel contains your panel gfx.  Music and a title page are
  44. optional.  This "index" file could also be called a configuration file.
  45.  
  46.  
  47.  
  48.  
  49. @2ENTERING ARTICLES@1
  50. -------------------------------------------------------------------------------
  51.         Each article is to be typed and saved as a normal ASCII text file
  52. from any word processor. Note that ansi and styles (italics, bold, etc.)
  53. are not currently supported. Once you have your articles ready on a blank
  54. disk you can use Magnum. Try to keep each article to no more than 200
  55. pages (4800 lines).
  56.  
  57. Colour commands are available to choose from 7 text colours.
  58.  
  59. In your text, type a number after  @  to choose a colour...
  60.  
  61.  1-White (default)
  62. @2 2-red
  63. @3 3-yellow
  64. @4 4-green
  65. @5 5-cyan
  66. @6 6-blue
  67. @7 7-purple
  68. @1
  69. If you don`t understand, load this file into a word processor to have a look!
  70.  
  71.  
  72.  
  73.  
  74. @2POWERPACKED FILES@1
  75. -------------------------------------------------------------------------------
  76.     Magnum does not internally support Powerpacked graphics, text, and
  77. music files.  You can avoid this problem and fit more on your disk by using
  78. a superb little utility called  POWERPATCHER  by  Michael Berg.  Just run
  79. this program before you load up the main Magnum program and you will find you
  80. can read packed files.
  81.     Please read the @6PP.docs@1 for more information.
  82.  
  83.  
  84.  
  85.  
  86. @2CONTROL PANEL GFX@1
  87. -------------------------------------------------------------------------------
  88.         The control panel you are using below can be changed to suit your
  89. taste. The graphics panel must be low-res and in 16 colours. A
  90. stencil and example is on the disk to help you (panel.iff). The panel when
  91. complete should be saved as a brush Magnum.panel onto your disk.
  92.  
  93.  
  94.  
  95.  
  96. @2GRAPHICS@1
  97. -------------------------------------------------------------------------------
  98. Graphics can be displayed as a single page.  They must be NTSC in size and
  99. standard in width (320 or 640).  Pictures can be in Interlace, HAM, Low, Med,
  100. and High resolution.
  101.  
  102.  
  103.  
  104.  
  105. @2MUSIC@1
  106. -------------------------------------------------------------------------------
  107.         Music can be run in the background so you could have Octamed,
  108. TFMX or whatever music running. The Music on/off function only applies to
  109. music done in a special format so using the first method means you cannot
  110. turn it off. Since this function is rendered useless, yo can simply draw some
  111. graphics over the unused panel. (logo?). The program will know whether there
  112. is music resident in the special format. @3CONVERTER@1 is supplied on disk to
  113. convert SoundTracker music to this format. This converted music should be
  114. saved under the name Magnum.music on your disk.
  115.  
  116.  
  117.  
  118.  
  119. @2TITLE PAGE@1
  120. -------------------------------------------------------------------------------
  121.         The title page can be whatever you want, making sure that it is
  122. IFF of course. Your completed picture should be saved under the name
  123. Magnum.title.
  124.  
  125.  
  126.  
  127.  
  128. @2INDEX FILE (CONFIGURATION FILE)@1
  129. -------------------------------------------------------------------------------
  130.         Now a text file must be created to tell Magnum where your articles
  131. are on the disk, and what it should show on the menu. You can load up the
  132. example file on this disk, Magnum.index . Below is an example...
  133.                 
  134. f00             - Colour of line at top. The number is typed in hex format
  135.                   and you must remember to press return afterwards...
  136.           This example will be RED.
  137. fff             - Top text colour. (WHITE)
  138. fff             - Mouse colour (WHITE)
  139. f00             - Mouse border colour (RED)
  140. My Disk Magazine- The title of your disk magazine. (No more than 30 chars)
  141. Article 1       - A1. The name of your first article
  142. df0:drw/file    - A1. Path of article (where file is on disk)
  143. Article 2       - A2. Another article...
  144. df0:drw/file    - A2. Path again...
  145. *empty*         - A3. Putting *empty* leaves an empty line
  146. YO DUDE!        - A4. To create a message, place message and then put *empty*
  147. *empty*         - A4. so that when YO DUDE! is chosen, nothing loads.
  148. King Tut        - A5. To load an iff picture, place
  149. *iff*df0:d/f    - A5. *iff* BEFORE the path
  150.  
  151.         You can continue the name and path of this article to a maximum of
  152. 500 articles. You must also remember to press RETURN after EACH line.
  153. This file should then be saved under the name Magnum.index .
  154.  
  155.  
  156.  
  157.  
  158. @2CONTROLS@1
  159. -------------------------------------------------------------------------------
  160. The icons are self explanatory, and there is a help file on disk.
  161. Keyboard shortcuts are as follows.
  162.  
  163.  @3Esc          @1= @7Return to index
  164.  @3Shift + Esc  @1= @7Quit
  165.  @3Return       @1= @7Load file
  166.  @3Space bar    @1= @7Goto page of index/article
  167.  @3s            @1= @7Sound on/off
  168.  @3Up arrow     @1= @7Goto 1st page of index/article
  169.  @3Down arrow   @1= @7Goto last page of index/article
  170.  @3Left arrow   @1= @7Move back a page of index/article
  171.  @3Right arrow  @1= @7Move forward a page of index/article
  172.  
  173.  
  174.  
  175.  
  176. @2TIDYING UP@1
  177. -------------------------------------------------------------------------------
  178. So now you should have on your disk:
  179.  
  180.         @4Magnum.Panel  @1- your gfx
  181.         @4Magnum.Title  @1- title page (optional)
  182.         @4Magnum.Music  @1- (optional, you can use your own player or not have
  183.                         any music at all.)
  184.         @4Magnum.Index  @1- your file of names and paths
  185.  
  186.         Now all you have to do is to copy across the Magnum.prg file to
  187. your disk and also Diskfont.library. If you don`t know how to do this with
  188. the CLI, then load up the @3SET_UP_MAGNUM@1 program on this disk and follow all
  189. onscreen prompts. It will also create a startup-sequence (as below).
  190.  
  191. Now all is needed is a startup-sequence. Make your startup boot
  192. up Magnum.Prg or your own music first, etc.
  193.  
  194.         eg.
  195.  
  196. @4                  MAGNUM.PRG
  197. @1
  198.         or
  199.  
  200. @4                  RUN OCTAMEDPLAYER >NIL: <NIL: name of music
  201.                   MAGNUM.PRG
  202. @1
  203. Check your manual for help if you are confused.
  204.  
  205.  
  206.  
  207.  
  208. @2ABOUT@1
  209. -------------------------------------------------------------------------------
  210.  
  211. @3      Programmed in AMOS@1...........@6W.H.Liu (Simon)
  212. @3      Music@1........................@6Faculty
  213. @3      Converter@1....................@6Francois Lionet
  214. @3      Example panel@1................@6Fish
  215. @1
  216. If you find any bugs or have any ideas for future versions, please write to
  217. me (address below.)
  218.  
  219.  
  220.  
  221. I retain full copyright of the program and it may not be altered in any way.
  222. This program is not shareware so you have no obligation to register this
  223. program with me.  However, I do supply updates if you wish so.  If you
  224. register to receive updates you will also get technical help if you have
  225. problems using this program.
  226.  
  227. To register for help and updates on day of release:
  228.  
  229.  
  230. @2        FEE    (Sterling)       @1|@2      UPDATES
  231. @1---------------------------------------------------------------
  232. @2     10.00 pounds@1               |@2     2 updates
  233. @2     15.00 pounds@1               |@2     5 updates
  234. @1---------------------------------------------------------------
  235. Payment should be by @7EUROCHEQUE@1 and made payable to @3"Wai Hung Liu"@1.
  236.  
  237.  
  238. All mail should be addressed to:
  239.  
  240.             Simon,
  241.             c/o "Magnum"
  242.             90 Terenure Road East,
  243.             Dublin 6,
  244.             Ireland.
  245.  
  246. @2NB: Please enclose an SAE for a reply to comments, bugs, etc
  247.  
  248. .@1I hope you find this utility useful!              ##:-)
  249.  
  250. @2       //
  251. @3      //  @6"ONLY AMIGA MAKES IT POSSIBLE!"@1
  252. @4    \X/
  253.  
  254.  
  255.  
  256.